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LcTTIiRSE-r MANIPULATION UTIlITY INSTRUCTIONS 

^^ The following documentation is designed to describe the use of our net 
J^aphic Manipulation routines. These are the same routines we have been usinc 
in-house for some time. Their use requires that the user be familiar, if nai 
proficient, with the use of our GEAP and Dot Writer packages. This documentatiar 
is complete, however, it is assumed that the user has a good understanding' oi 
jrjth our programs and his own Computer and DOS. We will document only our 
programs and not the various Dos' that you might care to run them under. 

The programs are BASIC control modules with MACHINE LANGUAGE overlays. TheL 
load like BASIC programs but each routine will call its own support programs. For 
this reason, the entire group of programs must be on line when in use. It is 
permissible to begin a program and then to remove the disKette and replace it with 
another dish when the object file is called for. In most cases, this will work, 
however, we recommend that two drives be used for the most efficient operation 
of the utility. 

Your utility disk contains the following programs 1 

2 3. HN 

24. MAGEX^ 

25. HG 

26. BL 

27. ROTATE 

28. FILTLET 

29. DEBUGLET 
33. UD 

31. SPHL/CIM^ 

32. RT 



II U IJ (I I U G THE HflUIPULflTIOM PSOERfRH " 

Each ietterset / graphic manipulation routine is a separate program. That 
should be obvious by the filename list above. For ease of operation these 
programs have been linked with a program called "LETHENIT. LETHENU is a menu of 
the facilities, listed by function, not program name. Each routine or series of 
routines can be selected from LETHENU and, in turn, each routine ends with the 
option to RERUN, RETURN TO MENU, or END. RERUN restarts the utility just used, 
RETURN TO MENU will take you back to LETHENU and END b' ngs up a BASIC READY 
prompt. 
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Running the "LETHENU* program is quite simple. Bring up BASIC, be sure that 
yuu specified four (4) files, and RUN *LETHENU B . There is nn need In set memory 
size. Each DOS has its own method for running BASIC and setting files so check your 
DOS for this information. Here is an example of the setup using DOSPi.US 3. 4. : 

From DOS READY type- BASIC LETHENU-F: 4 <ENTER>. 

This command format will load BASIC with 4 files set. It will also load and run 
the 'LETHENLP program. AGAIN - THIS FORMAT APPLIES ONLY TO DOSPLUS. You must 
follow the procedure required by your own DOS! 

THELETHEUU DISPLflV 

Following is a display of the same menu you will see on your monitor when you 
run the "LETHENIT program: 

Letter Manipulation Utilities 

1 split letter into pieces, magnify pieces 

2 copy between lettersets 

3 format new lettersets 

4 list blanKs in letterset to printer 

5 list byte dump of letter(s) to printer 

6 italicize letterset 

7 move Jetter(s) within frame, and/or justify op center 
B merge string with letter<s) 

9 expand or magnify letter(s) within frame 
19 add wiggle to letter(s) 

11 rotate and/or mirror image letter 

12 find minimum storage values 

13 run DOT NRITER • ■ . 
<ENTER) number of your choice ... 

In order to select an option, simply type the number of the routine and hit 
<EHTER). The desired routine will automatically load and will in turn, load its own 
routines. 
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Now let's take a look at each routine and briefly examine its operation. 
Remember, we will expect that you are already familiar with the DOT WRITE / GEA 
graphic creation routines. He will not spend any time explaining those facilities.' 

CHOICE 1, THE BPLIT 8 U T I « E 

The split routine will allow you to enlarge and refine" a graphic in ths 
fallowing fashion. First, remember that each graphic is designed in a frame. Fdi 
point of example we will use the full screen as the frame but, the actual frame 
can be any size from 1 dot wide by eight dots high, to 128 dots wide by M-8 dot; 
high. Also remember that, even though the width can be incremented by single doi 
units, the height must be incremented by printer lines where i line equals 8 dots 
high. 

Once you have designed your graphic, be it a letter or a picture, you wil. 
assign it to a Keyboard character. For our purposes we will always assign the 
original graphic to the *i " character. With this character saved under a filename 
(ALPHA for example) you can now run the SPLIT program. 

^ When run, SPLIT will asK you for the file containing the graphic you wish tc 
f^Dlit. In this case, reply ALPHA. Mext, you will be asked for the keyboard 

character that the graphic was saved under. Reply *! * (don't include the quotes). 

Finally, you will be asked for a filename for the output file. We will use BETA. 

Now the SPLIT program begins its wgHl You will see what is happening on the 
video display. As an aside, when we first started working with these programs 
they were all VERY slow. Some were so slow that you could start the routine anc 
go out to dinner. When you came back, providing you're a slow eater, the routine 
would be finished. You will see however, that the routines are all very fast not* 
and many occur so quickly they will be hard to follow. 

The SPLIT program will first divide the graphic FRAME into four parts. Eatif 
of the four parts will then be magnified PROPORTIONALLY to fill the entire size ai 
the original frame. The resulting four Quarters, which are now each as big as the 
original, are stored under the keyboard characters ", « S, */. No file creatiar 
is done at this point. 
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SPLIT will now ask you if you want the procedure to Be run again. If you 
respond NO, the new graphics will be stored under the above Keyboard characters 
and placed in the file we named BETA. Each part will be as large as the original 
and each can be loaded separately for editing. In order to print out the larger 
graphic, you would use either GEAP or DOTPRINT and would load file BETA with either 
the H command (GEAP) or the . BF BETA command (DOTPRINT). Then, by printing the 
four sections in order 2 " '.'- 

a-/. 

you will be able to recreate the original graphic only H times as large. 

If you answer YES to the RUN AGAIN prompt, the entire procedure will be 
rerun on each of the four quarters, maKing a 16 times larger diagram. Following 
is a layout of the characters that each segment will be saved under, in their 
relative positions 1 

KEYBOARD SYMBOLS 




ORIGINAL 




GENERATION 1 




i 



SSBSSaEKSH 



w^MT mjmmtfmp*- 





GENERATION 2 



Now let's look at an example of how the 5PLIT program works. First we start 
with our drawing in file ALPHA stored under character *! *. I'll use the" . GF 
command to load ALPHA. 
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This little logo was created on one screen of GEflP. Now I'll SPLIT it into 4- 
parts and display each of the 4- parts separately and then together. This will bs 
file BETA, and the characters will be " » $ and */. First I'll display them in that 
order, then in the proper order: 

$'/ - -": 





#Note that each of the four parts is now the same size as the entire original 
aphic. You will also note that the first SPLIT of the graphic caused a stair step 
~ effect in the angled sides of the graphic. Now, with a little editing with GEAR and 
Dot Writer, I can smooth out the rough edges. 



i "Vi-msm'muiis'Vtr uvtm 



ftXMM.intuuy.iaHri, 
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2223232223 




jy'iMIHS 
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very magnification will increase the BLOCK appearance of the resulting 
raphic. Oe sure to edit the result of the magnification to smooth out the lines 
nd round out the edges. 

The 16 time split worKs in exactly the same way. Refer to the diagram for 
he character layout. Also, when you use the 16 times split, the character edges 
ill be even rougher than with the M- times split. Again, each resulting character 
an be edited and this is an easy procedure since the split sections are 
raportional. fill edges will continue to match up. 

That is all there is to it. With the SPLIT routine you can easily create a 
raphic up to 16 screens in size. Now let's move on to the next routine. 

In the discussion of Option *1, the SPLIT routine, I gave an example for you 
a follow. In most of the following sections I will not give you an example but will 
ixplain the use and prompting procedure. Later in the manual, you will see how 
hese routines can be used together to create lettersets and advanced graphics . 

While some routines liKe SPLIT and NIGGLE can be best explained hy example, 
ithe^s, such as COPY LETTERS and FORMAT are too simple to demonstrate. For 
»(^pe, the FORMAT routine formats a file to your specifications. You tell it how 
la'ny dots wide and how many printer lines high the file should be and it does the 
'est. There is really nothing to demonstrate. 

Don't worry though. I'm not going to leave you out in the cold. Far the 
'autines that fall into the SIMPLE category, I have made sure that there are 
adequate examples of their use in conjunction with the other routines. 

CHOICE H, THE COPV LETTER ROUTIIIE 

This is one of the simple routines I spoKe of. No glamour here! • With COPY you 
:an copy the letters (any one or group of letters) from one file to another. This 
naKes it possible to taKe the lowercase characters from one font and place them 
nto the position of the lowercase characters of another font. The only 
requirement is that the receiving file frame size must be large enough to hold the 
ncaming letters. Don't get me wrong! You can copy a large letter into a small 
"rame - but the result will be a chopped off letter. 
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Let's take a looK at the procedure. First, get an ASCII character order 
chart. There is one in the GEAP manual, one in the Dot Hriter manual, it is also 
printed on the 'cheat sheet* that comes with the Dot Hriter manual and, finally, I 
have included one of the Dot Hriter 'cheat sheets* with this manual so you will' be 
certain to have the info! Remember that Keyboard characters, regardless of what 
you have stored under them, are stored on the disk in ASCII order from the LDHEST 
value to the HIGHEST value. That means (look at the chart) that the *! * is the first 
character in the file and the "z" is the last! 

OK! Now that that's out of the way, we'll select option *2 from the menu. 
You are prompted for the name of the file to be copied from-' That is the INPUT 
FILE. Type in the name of your SOURCE file (that's where you want the letters to 
come from). Next you will be asked the name of the file that the copied letters are 
to be sent to-' That is the OUTPUT FILE. If the OUTPUT file is the same as the INPUT 
file (for example, if you want to duplicate the uppercase characters into the 
lowercase positions) you need only enter -1. That will make both the INPUT and 
OUTPUT file the same. 

Now that you have the files specified, it is time to specify the characters to" 

4fce copied. In order to specify the range of characters, you must know what order 

Characters are stored in. That means you must use your ASCII chart. For 

argument's sake we'll assume that we are going to transfer the lowercase of file B 

^into the lowercase position of file A. The INPUT file is *B* - that is the source 

-The OUTPUT file is 'A* - that is the destination. ... ■.-.-■•" 

Now you will be asked for the LOHEST character to be copied That means: 
Hhat is the LOHEST (in ASCII value) character you want to take from the source (E) 
file? Since we are copying the lowercase, the answer would be??? Right! the 
answer is *a\ Look at your chart and see that, of all the lowercase characters, 
'a* has the lowest ASCII value (37). You will further note that the highest ASCII 
value is *z* with a whopping 122. Isn't it convenient how they came out in order? 
So, for the LOHEST character to be copied you will respond *a*. 

Your next prompt will be for the HIGHEST character to be copied. Again, this 
refers to highest in ASCII value and of course, the answer in our example will be 
*z*. Now we have specified the range. In fact, our range is the entire lowercase 
'a* to *z*. If we had wanted to copy only one character we would simply specify 
the same character for both LOHEST and HIGHEST. Easy isn't it? 
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Now for the last step, fill we have to do now is to tell the COPY routine 
where we want our range of characters copied to. He have given it the filename 
so we need only tell it where in that file to store the letters. He have also told, 
the COPY program the range of letters (how many) we want to copy, fill that is left 
is to tell .the COPY program where to place the first (LOWEST) character. The final 
prompt is for the LOWEST character to be OUTPUT. The program is asking you for 
the location where it should start placing the range of letters we "selected. Since 
we are copying the lowercase into the lowercase position, it would be a goad idea 
to place the "a* into the "a* position. So the correct answer to this final prompt 
is "a u . Now the program will do the rest. The "b* will be stored under a b w , a c a 
under "c w , and so on until the range is complete and the copy function is done. 

Just suppose for a moment that we had answered *A S .for the final prompt 
instead of "a*. What would have happened? No, don't guess, because I'm going to 
tell you anyway. If we had made that error, the entire lowercase of file a B B would 
have been stored in the uppercase locations of file "ft*. When we typed out the file 
later an, the resulting text would be somewhat disrupted. 

Not much to it is there? Well, don't be deceived! Once you begin using this 
pacKage you will find this little COPY routine very valuable. Suppose you create a 

• of all fancy, uppercase letters. You have spent hours detailing and 
jging this work of art. Now you sit down to type and you realize that you must 
ALWAYS remember that when you use this font, the entire text NU5T be in 
uppercase. If you let a lowercase letter slip in you will not get a beautiful 
uppercase replacement. You will get garbage. Well, copy the uppercase into the 
lowercase positions dummy! There, one less thing to worry about. 
Now let me briefly tell you of the foibles of the COPY program. First, if you copy 
a letter from a small frame size file into a large frame size file you will get a 
complete and accurate transfer. However, the small letter will be padded to fit 
the larger frame and will not necessarily look good with its new frame. ..'The closer 
in frame size two lettersets are, the better they will look together. Second, if 
you transfer in the reverse direction, a large frame size into a smaller frame 
size, the larger letter may be cut off. . I say a HAY HE CUT 0FF° because a 
letterset does nGt absolutely have to be in an exact fit frame. If the larger 
letter is only a little larger, it may be OK. However, if you copy Olde English 
into the Microprint frame, I can guarantee you that the result will be garbage! 



.„j 
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There is a problem with using this routine. It only worKs on 3 clean disK. If 
garbage has been saved into a letterset file, or if an aborted letter creation 
has been saved, that garbage or part letter will be counted as a letter. The 
best way to avoid this problem is, when you create a letter that you don't liKe 
and you want to try it again at a later date, save a BLANK frame to that Key 
location on disK. The method for doing this is part of the DOT WRITER program. 

CHOICE 5, THE BYTE DUHP ROUTINE 

Again, this is a simple routine. The object is to dump a list of the actual 
byte layout of a graphic or range of letters. On the EPSON printer, the letter 
itself is actually printed. The operation is self prompting. You will be asKed for 
. the filename of the object file. Then you will be asKed for the LOWEST letter and 
l then the HIGHEST letter to be dumped. The range you specify is based on the ASCII 
Jtable you have been supplied. If you wanted to dump a whole letterset, you would 
^specify *! ' as the LOWEST letter and *z* as the highest. If you only wanted to dump 
t one letter, say the *B*. you would specify that letter for both LOWEST and HIGHEST 
1- letters. 

; '(^P This particular utility is designed for the advanced user and has little 
practical application for the average user. One of our main uses is when we 
copyright a letterset. We copyright the BYTE DUMP as well as the appearance of the 
letter and the name. This gives us double protection. 

The remaining utilities (with the exception of number 12) are relatively 
difficult to use. Rather than crash on through, I'll start a new section for the 
| remainder of the utilities. 

' CHOICE £, THE ITALICIZE ROUTINE 

| The italics option is relatively easy to use, however, it offers some unique 

:j challenges to the user. Let's first consider the prompt sequence. 

When run, the italics option will first ash for the input file. This is the 

name of the file you wish to italicize. The second prompt is for the name of the 

output file. The output file can be the same as the input file BUT it is usually 

necessary to specify a new file due to different size requirements. I'll give you 

, mare on that later. 
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When ycm use the italic feature, the tap dot pattern of each graphic will be 
shifted to the right by some amount that you will specify (tilt factor). The easiest 
way to avoid chopping off letters is to do the following 1 
I Run the byte dump routine to get the frame size (only the width is needed) of 

the root file. You could also run option 12, minimum frame, and get the same 

information. 

2. Nun, add an obviously large frame width to that number. Fop example, if the 
(Tame width of the root file is 33, double it to 66. This will never pose a 
problem except in extremely wide fonts where you might hit the 128 max. 

3. Use the FORMAT option and create a file that is wider than the root file but 
uses the same number of printer lines. 

•+. Next, use the copy routine to copy the root file into the larger file. You will 
also 'want to run the HOVE / JUSTIFY routine. 

5. When in the move / justify routine, left justify the new large file. I have 
also found that it saves trouble if you move all letters one dot right after 
the justification. 

6. How run the ITALIC routine until you get the looK you want. Hhen you are 
satisfied with the tilt of the letters, run option 12 and find out ,ihe smallest 
(frame you can get your new font into. Then, create the new file and copy the 
italic font into it. That is all there is to it and though there are shorter 
ways, this is the safest. 

How onto the next routine. The following HQUE / JUSTIFY routine is a bit 
involved so be prepared to sit down at your computer and try to follow along. The 
routine isn't difficult but there is a lot to it! 

CHOICE 7, HOVE / JUSTIFV 

I'm going to attack the explanation of this routine in a very systematic 
manner. Not because it is difficult but rather, because it can do so much. First, 
I'll list the features: You can CENTER any letter or range of letters within a 
specified file. You can HDUE any letter any number of dots in any of the four 
directions within a frame. You can LEFT JUSTIFY the letters (move them all as far 
to the left as they will go) or you can RIGHT JUSTIFY the letters (move them as far 
to the right within a frame as possible). Each one of these manipulations is 
valuable when creating a letterset or graphic. Also, hitting (ENTER) in response to 
any prompt will skip you to the next prompt in the sequence so you don't have to 
concern yourself with dealing with an unwanted feature. 
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^ Now a look at the program operation. The first prompt is for the INPUT file. 
As in all cases, that is the source of the letters or graphic you are working on 
The second prompt is the OUTPUT file. Again, this can be the same as the INPUT fih 
or it can be a different file with corresponding dimensions. 

Next, you will be asked for the LOWEST and HIGHEST letters you wish to warl 
on. This is the same range specification technique we have used throughout Uiesg 
programs. As you can tell, you will be able to work on 1 letter or any range of 
letters. 

Now for the tough part. The next prompt is for LEFT JUSTIFICATION. If you hit 
the (ENTER) key the feature will be skipped and you will be prompted for the RIGM1 
JUSTIFY. If you respond YES to the prompt, you will jump onto the next prompt, 
(which is move up / down or left / right). For now let's just consider the JUSTIFY 
command. If selected, each character in the range will be moved as far to the 
left as possible. This means that a character such as *! * will be moved farther 
to the left than a- "H\ You may see this in your output when you type For 
examples this LQ letterset was LEFT JUSTIFIED and as a result, the characters ", 
\ , and *, were moved as far left as possible. When typed in .. sequence, the 
Justification makes the I look closer to the * than to the \ See a ! * . This is 
f^P^y a problem for some of the narrower characters. The problem can be 
^corrected by simply specifying the range so that the punctuation characters are 
not justified. 

The RIGHT JUSTIFICATION works in the same way but the justification moves the 
characters to the right of the frame. The same problems exist in reverse. If you 
do not choose a JUSTIFICATION feature, you will be asked if you want to CENTER. 

The CENTER feature centers the characters from left to right only. There is 
no up and down centering. If you select LEFT justification, you will not be given a 
chance to select CENTERING or RIGHT justification. That makes sense doesn't it? 
Regardless of whether or not you select CENTER, or LEFT / RIGHT" justification or 
opt for none of these ±jou will get a chance to move UP, DOWN, LEFT, RIGHT. 

After getting through the above three choices, and whether or not one of 
them was selected, you will now be prompted for HGUE (U)p, (D)own or <N)o move, li 
you select either UP cr DOWN, you will be prompted for the number of dots to n»nv« 
the letter. If you select UP, DOWN or NO move, you will still be prompted for- the 
HOVE (Rhght, (Deft or (N)n move. Again, selecting a positive move will ppsuit in a 
prompt fcr the number of dots required. 



C 
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ir you wish to EXPAND a letter (a later option) you will need to raove the 
letter exactly 1 dot from the left side of the frame. The easiest way to do this is 
to LEFT JUSTIFY and then ROUE RIGHT 1 dot. Certain cognations do not warK 
together.. For example, the JUSTIFICATION does not function with the HOUE 
selections.- Tiiat has to be dome in two moves. ; 

You'll get a chance to use this routine in our example later on in the 
manual. Again, this is very simple but does require a little forethought! 

There are only two features of this utility that I dread trying to explain 
They are MERGE and HIGGLE. Since HERGE is next I think I'll take a break before" I 
start. I suggest you do the same. Take soiste tinae to run through the routines 
described so far. They are easy to use and will give you a world of power If you 
get stuck, look at the example at the end of the manual. It will give you a run 
through, Also, if you get stuck, I suggest that you go back to GEAP and DOT NRITER 
and get some practice. These routines are for the EXPERIENCED users and we 
assume thsft you know what you are doing. For an experienced user, all of this is 
child's play! 

CHOICE a, 1UE HE2SE U0UIIHE 

(W 

v - Qkl I've put this one off long enough. Here is the HERGE routine. To start 

with, a brief explanation of what the HERGE is for. 

Basically, ail the merge . command does is ADD or SUBTRACT a specific string 
from each character in a letterset. If for example, you wanted a permanently 
underlined font, you could create the underline, save it to a file, then HERGE it 
into each character of the object letterset using the HERGE routine. Then, each 
character in the letterset (or and range thereof) would have the underline added 
to it. In reverse, you could use the HERGE command to remove the . underline from 
Ihe letterset. 

Hon to do it? Nell that is what J have been dreading. But, for an example 
let's use the PL letterset. By now, all of you know that the PL set is very similar 
Id the norma] EPSON (or C. Itoh) letterset. It is based on 10 CPI although the 
proportional feature may change that number during actual printout. We're goinn 
to add a lit tie graphic character <a line with a circle centered on top) to thy 
bottom of each character in that font. 
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The first step is to find out where to put the graphic string in the frame. 
That part is easy for you experienced users. Run EXPHQD8 and transfer ; 
lowercase letter (like the *g*) onto the screen. This will do two things. First, ' wi 
get the letterset frame to work in. Second, we find out how low we must go wit; 
our graphic to avoid the bottom of the lowest character. 

Step two is to create the graphic in the space available in the frame. If jdi 
are doing your own graphic, you must thinK things out. For example, if you wan 
to add a graphic to the side of a character, you can't really use the letter T a; 
the frame character. If you do, and you place your graphic too close, the wiriei 
letters (like the "M") will be blitzed. Think things out! In our case, we havt 
plenty of room below the lowercase letters to create out little line with a circle. 

WARNING! WARNING! WARNING! DON'T TRY THIS ROUTINE ON YOUR ORIGINAL FONT! Ii 
can shatter a lot of work if you mess it up. Be sure that you work with a WORKINI 
disk that contains only copies of your good fonts! Now, create the graphic. I'n 
going to create a line that is the full width of the frame. I am also going U 
create a little circle on the top of the line and centered in the frame. You can d[ 
what you want. 

Now that you have created your graphic, it is time to save it. First step! 

Go into the DESIGNATE mode and then to the a U0 tt menu. Option #1 allows thi 

operator to enter the file name. The name of the module you want is SUSTRKG. This 

is an expansion module to GEAP but it is on your MANIPULATION disk. See the lis I oi 

filenames in the front of the manual if you don't believe me. Hhen you have loader 

SU5TRNG (save string) you will be returned to the DESIGNATE mode and your graphi-: 
will be returned. 

Now you have to find out where the graphic sits on the screen. This is ths 
PRINT AT location and can be obtained by entering the KEYPAD (0 mode and placint 
the cursor at the portion of the graphic that is farthest left- in the frame ANI 
closest to the top of the frame. In other words, the LOWEST screen locatior 
occupied by the graphic. Now hit the (ENTER) key and note the PRINT AT location thai 
will appear at the top of the screen. This part may take some practice. I have 
found that it is easy to erase part of the normal letter by using the wrong PRIM 
AT location. Fly by the seat of your pants for a while - you'll catch onJ 
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Now make your graphic the DESIGNATED figure. You ail know how to do that. HE 
SURE THAT YOU ONLY DESIGNATE THE NEH GRAPHIC. If there is some overlap, erase the, 
offending parts, including any of the frame boundary. To be on the safe side it is 
easiest to erase everything except the graphic that you will add (or subtract). 
Once you have designated the figure you can save it to a file. 

This is an easy step. You should have already loaded the SUSTflHG expansion 
module. If you haven't, do so now. Go to the DESIGNATE mode (you will probably be 
there by now) and press the S S U Key. You will be asked for the name of the OUTPUT 
file. This is the name that you want to use as a graphic. Since I have created a 
lit Lie LOOP to go with the PL letterset, I'll call ray file LOOP. Name yours as you 
will and specify the disk drive in the name. This is optional but it is a good idea 
to get into the habit of specifying drive numbers when working with utilities. It 
keeps you from wrecking a lot of work! 

With that done, It is time to run the LETHENU program. Of course you want to 
seiect CHOICE *B, MERGE. Once loaded the merge program will ask you for the name 
of the INPUT (source) FILE. This refers to the letterset that you want, .to add to or 
su^act from. In my case it will be PL. The next prompt Is for the' name of the 
(^pT file. This is the destination name and in my case, since I am adding a LODP 



T .. 

uvj the PL letterset, I'll use the name LOOPPL. 



Now comes the standard part of each of the routines. That is range 
specification. You are asked for the LOWEST value and the HIGHEST value. As 
always, you can specify whatever range you want. In my case, I'll specify the 
entire letterset, *l * is the lowest character and "z* is the highest. 

MERGE will also ask for the name of the file that contains the string to be 
added or subtracted. For the sake of the example, I use LOOP as the string name. 
So I would answer LOOP: d. Next you will be asked if you want to (A)dd or (S)uhract 
the graphic string. You might think that DESIGNATING a blank area would be best to 
remove a string but it isn't necessary. If we add a string, we may want in 
subtract it tool Just answer *A* or *S U . For my font it will be U A U for add. 

QK! MERGE is off and running and you see in the upper left of your screen a 
dazzling display of addition of a character to rapidly flashing characters! 
BLAHHOI It's done. SAUING appears on the screen and LOOPPL is created. Let's tvq a 

Lest print! 
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DID IT WORK! YEP, SLICK AS CAN BE! 

M.M.M. M.M. M.M.M.M.M. M.M.M.M. Ji.M-M.JLM. AM. JLM.M. M.M.M. 



I can't believe I just got through that. Looking it over - it even made: 
sense!. That is the MERGE routine. With it you can create or remove staridarc 
character strings. Now that that is over I only have two more toughies to csa 
with. I'm not going to jump in though! I want you to spend a little time with thi« 
MERGE routine. ThinK it out. Get the feel. Give yourself some "time to understand 
it and me some time for a drinK and some thought before I have to crash into the 
MAGNIFY / EXPAND routine! 

CHOICE 3, H fl G U I F V / EHPfJHD 

Here we are again, ready to assault another frontier, climb .another 
mountain, face another adventure and cliche ad infinitum! This little beauty i? 
'the MAGNIFY / EXPAND routine. Let's start by explaining what MAGNIFY is in relatioi 
to expand! 

First* MAGNIFY means to make larger. That is what we do. He make a "lettei 
or graphic iarger. This routine will increase the size of an entire letterset as 
Jfcst as Superman can save Lois Lane. The resulting letters may need some deanini 
^fp since magnifying causes a little squaring of the previously round letters. Thii 
^ is much the same as in the SPLIT routine. 

EXPAND on the other hand, not only increases the letter size, but alsi 
breaks it apart into dots! . 5ay what? That's right. Hhen we expand we actualli 
pull the dots apart by a specified number of dot widths. This can occur in batl 
directions. You'll get a better idea of this when I EXPAND this LQ font right befors 
your eyes! 

But, that is enough for now. I lied before. I said I was going to take s 
break and I didn't. How" it's 3^ @0am and there is a limit to even my dedication. 
See you in the morning! 

Boyt It seems like only a few minutes ago I was saying goodnight and here i 
in, morning. Well, I have six cups of coffee, a note pad and the kids are fightin 
- just the rioht atmosphere to continue our discussion. He are going to start wit 
the HAGKIFY /EXPAND ru-utine aren't we. Ok. Let's get to it. 
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We'll start with MAGMIFY since it is the simplest. General rules first! The 
MAGNIFY routine ALWAYS gives 2 times magnification. That means that a 1(3 dot wide 
by 2 printer line high font will require a frame size of 29 by *h To create this 
frame size in a receiving file use option 3, the FORMAT routine. In the case "of 
bath the MAGNIFY and EXPAND routines, it is also necessary to move the intended 
characters one dot width from the full left justified position. So, the first step 
if the root font is left justified, is to run option 7 and move the' letters one dot 
to the right. This is only necessary if the letters hit the full left border It also 
applies in reverse, if the wide characters hit the right extreme. 

In my example I am going to use the LQ font and it is fully left justified Hlj 
first stem is to find out the frame size. By. now it should be clear that there are 
several ways to do this. I usually just run EXPHDDB and transfer a letter to the 
screen. Then I count the frame size out. The LQ font is 15 dots wide by 2 printer 
lines (16 dots) high. 5o, for the magnify routine I will have to make some 
modifications. The first step is to run the MOVE routine and move every letter In 
the LQ font one dot to the right. . 

Next I have to format my files. LQM will accept the magnified version so I 
fDjjmat it to 2x15+1 or 31 dots wide by 2X2 or H printer lines. A little 
ffMination. While I only doubled the printer lines (2 times magnification) I had to 
uduble the width PLUS ADD the 1 dot that I moved the font to the right- 
Since I am in the FQRHAT routine I might as well format the the EXPAND file as 
well. I have decided to call the expand file Wtt and to expand it 3 times in width 
and 2 times in height. That means that the file must be 3X15+1 wide - that's 4-6 
dots wide. (Note that I added the one dot for the right move from earlier) And I 
will make the height 2x2 or H- printer lines. 

Now that I have formatted the files, I can start option 3. First I'll 
magnify. The first prompt is the INPUT file name - LO. The next/ is the .OUTPUT 
filename - LQH. The range is requested next and we will use the entire set a \ * \* 
the LOWEST symbol and *z a is the highest. OK. Jte're offi . The expand" routine 
flashes each LQ character. MAGNIFIES it 2 times and then saves it. That's it The 
finished product is saved. Let's have a looM 

AHCDEFG 
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You will note that the letters have become a little blocKy. Some individua 
editing may be in order. I'll pass that by for now. It's .part of the GEAP program. 

Now for the expand. The initial prompts are the same: The INPUT is LQ am 
the OUTPUT file is LQN. Hhen you select EXPAND you are asked for the number d 
expansions in the X direction. The X direction represents width.,-. He'll choos* 
three as we planned. 

Now we are asked for the expansion in the Y direction. Y represents heigh 
and is in printer lines. We'll stick with our original plan of 2. We're off again. 
The EXPAND will print the original character, then show the expand character am 
finally will save the file. Here_is the result of_out_expansion: 



«__ s 
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I know, it's nothing exciting here but just imagine what you can do with thi: 
utility and some re-editing. Add a few lines, increase the number of dots in a; 
area for darker patches. Instant art! . 

That covers the MAGNIFY/EXPAND routine. Next we have to cover the worst c 
f^khe group - WIGGLE. Wiggle is a bit on the extreme side. It allows you to offse 
' dot patterns in various combinations of sign waves. To be honest, I really dan' 
understand ail of its power! To make it easy for me to explain and to give yo 
something to experiment with, I'll give you a brief explanation of the routine an 
a few examples. You will have to take it from there and EXPERIMENT. This time i 
is a cop out. I could load this manual with examples arai still not have full 
explained the function. There are things like UP / D014H wiggles, LEFT / RICH 
wiggles, TAPERED wiggles, MAXIMUM SHIFT, INITIAL SHIFT and HIGGLE SPEED. One thin 
I will tell you though. The Higgle routine works best on complicated or larg 
graphics rather than simple lettersrjts like the one seen on this -manual. ^ For tha 
reason, I will include a GEAP logo which I will distort in various ways to* give yo 
an idea of what you can do. The rest is up to you. If ljou come up with 
particularly interesting result, let me see it and also explain what you did to gs 
it. I'll stick it into our user library for others to use and as a further guide. D 
- Here goes! 
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CHOICE 10, THE UIEELE B U T I U E 



I haven't been looking forward to this discussion but I've always felt that the , 
jest way to do worK you don't want to do was to jump in and get dirty, actually,- 
from a user standpoint, the WIGGLE routine is fairly simple. It's explaining it that 
is tough. I guess that the best way is to start with a normal graphic, and then 
higgle it a bit to let you see what happens. I'm not even going to try to give yau 
total training. Host will have to be experimentation on your part. Let me see 
dhat I can dol 

First, the explanation. The HIGGLE routine works best on graphics with full 
screen (12B x 6) dimensions. That is due to the nature of the routine. Essentially 
what we do is allow you to add a sign curve to the graphic. The wave effect can 
run from top to bottom or from left to right. He have also added a taper feature 
that allows the wiggle to die out before the edge of the screen, thus preventing 
cut cff of the graphic. • 

You will he prompted for the INPUT (source) and OUTPUT (result) file names as 
always. The next prompt asks if you want to use the (A)utomatic wiggle or the (R)oil 
yqj^uwn option. If you select the (R)oll your own option, you are asKed how much 
i IBSant to move EACH column. That is a big order but you can create some unique 
distortions of the graphic by using that feature. 

If you select the (A)utomatic wiggle you receive more prompting but the 
answers are easier. First you are asked for how many UP / DOWH wiggles you 
want. Yau are also prompted for the number of LEFT / RIGHT wiggles. This allows 
you to wiggle either way or both ways at the same time. 

For each wiggle ( UP / DOWN - LEFT / RIGHT) you are asked for the maximum 
shift. This number is the greatest number of dot offsets you want. I can't think 
of a better way of phrasing it than that. If you select 10 for example, no dot will 
be shifted more than 10 dot widths out of place. 

The next prompt asks for the wiggle speed. This is the number of peaks and 
valleys in the curve. The higher the number, the greater the wiggle speed and the 
mare peaks in the finished wiggle. 



^ 
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Finally, you will be asked if you want a tapered wiggle. This is important 
since without tapering, the wiggle could push the graphic out of the frame and 
thus, cut it off. Experimentation is the best way to see if a graphic will need 
taper to look right. The taper feature reduces the wiggle toward the edge of the 
graphic in order to prevent extending past frame. 

That is the wiggle feature. I Know it is a bit obscure, 6ut I did warn yau 
about it. I have tried tD explain it more clearly, however, the more I explain 
the more confusing it seems to get. Let me try out some examples on you to see if 
that will help. The following GEAP logo is done normally. Each letter is 
approximately 1 screen in size. 




(5 






Now I'm going to wiggle it. I'll use UP / DOWN only and I'll select 1 as the 
number of UP / DOWN wiggles. Note that each step in the wiggle is one dot offset. 
I'll aiso select a maximum shift of 5. No dot will be more than 5 dots out of place. - 

* wiggle speed of 4 will create 2 peaks and 2 valleys. An initial shift of 9 
mpletes the parameters and the result is : 




Now, if I use the same parameters and select a tapered wiggle the result 
will be* 
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A left / right taper results in the following distortion-* 






Now let's try a non-tapered UP / DOWN and a tapered LEFT / RIGHT, 
interesting result of this combination is* 



The 
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I'm afraid that's about all 1 can tell you about the HIGGLE routine. Use it and 
try different values. It won't taKe long to catch on and the results are worth it. 
Also, you can take heart in the fact that the worst of the utilities are over. The 
remaining ones are straight forward and you will have no mare to puzzle over! 
CHOICE 11, ROTATE / HIBROR IHHEE BOUTXHE 

Finally, another simple routine. You will be prompted, as always, for the 
INPUT and OUTPUT files, and the range of letters to be ROTATED. You will also be 
asked for the degrees that you want to rotate the object file. Since the TRS-BB 
(trademark of Tandy Inc. ) graphics are not square, the 9@ and 180 degree 
rotation produce the best results. Here is an example of the PL ietterset rotated 
90 degrees! 

2>Mnarn"nc3x»-«e J /*:r-3::za-n 
Now for the MIRROR letter option. Ydu will be fully prompted for input, and 
the output will be a. mirror image of the object Ietterset. As always, you should 
have a file prepared to accept the output from the routine. In the case of mirror 
image only, the output frame will be the same size as the input frame. In the case 
of rotation, read on. 

; ^fc There are a few warnings necessary. First, the routine rotates around the 
-^^nter of the frame so you should center the characters in the frame. Henu option 
7 will do that for you. Also, The rotation taKes room so be sure you have a big 
enough frame. The easiest way to do that is to create a large frame. Copy the 
object Ietterset into it and then center the resulting Ietterset. When the rotation 
is done. Use option 7 again and get the characters into the upper left corner of 
the frame. Finally, run option 12 and find the minimum storage size needed for the 
new Ietterset. Use option 3 to format that file and option 2 to copy the rotated 
Ietterset into the mininum frame. That's all folks! 

CHOICE 12; THE HIUIHUH 3T02AGE g U T 1 II £ 

This little beauty will save you a lot of time and it is easy to use. Once 
seiecled, this routine asks you for the object file's name. It then asks for the 
range of characters. In most cases it is best to specify ALL of the Ietterset sd 
the range would be "I * to "z*. The routine then checks every character in the 
range, selects the largest one and then computes the smallest frame necessary tn 
hold the largest character in the file. The result is printed on the printer. 
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W Willi routine, it i5 possible to work in a frame with PLENTY of room and still 
be able to reduce the frame size to minimum. It is best to have the character set 
left justified and moved all the way to the top of the frame if you want the 
smallest possible result. 

Once' you have the smallest frame parameters, use option 3 to create the 
file and option 2 to copy the letters into it. Another easy one isn't- it? -": 

CHOICE 13, SUN S) Y £JOTER 

This last choice is obvious. Selecting it allows you to enter Dot Writer 
directly from the manipulation routines. If you need to work in Dot Writer, select 
this option, do your work in Dot Writer, (BREAK) and then run "LETMENU* to get .back 
to the manipulation routines. This is an easy back and forth procedure for working 
on your graphics. 

Well, that is it for the overview. You have seen how each utility works and 
how to use them together to manipulate your graphics. You should now get even 
greater power from your GEAP and Dot Writer than ever before. If , you come up 
with^ interesting graphics or lettersets, remember we are always interested in 
*^g them. Also, if you have ideas for improving the programs please send them 
'ser feedback supplies us with most of our ideas. 

EBROR CHECKI&IE 



m 



Just a few words about error checking. When we first gathered together 
these programs, we didn't worry about error checking. Since they were only used 
in-house, we didn't think it was worth the time. But, the idea finally came to 
make these available to our users and so, we had to make them as user friendly 
as passible. A menu was created to allow for greater selection flexibility,- the 
programs were given, a final option to RERUN, RETURN TQ MENU or END and some 
error checking was put in. At the time of this writing, the program has some 
error checking. The error checking routines are fairly simple and there is no need 
to document them. If yau create an error, you will be flagged and most errors 
are not fatal (that means most errors will not cause a program crash and you will 
be able to begin again or return to the menu). 
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That is it for this manual. I'm sure that you will enjoy the programs and we 
are anxious to receive input from users telling us what they think about the 
routines and what types of routines they would like to see in the future! 

IN CASE OF PROBLEMS 

If you run into problems using these routines, please call Rick HcGarvey 221 
Hirschifeld Dr. , Williamsville, NY 14221 (716) 634-3B26. I try to keep normal 
business hours but my schedule prohibits me from being on hand all the time. If you 
get the answering machine, don't be shy. Leave your name and address and your 
phone number and a description of your problem. You'll have plenty of time sq 
there is no need to rush. In turn, I'll get back to you as soon as passible with 
information on how to defeat the difficulty you are having. Thanks! 
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t o 

"A" 5 

"E" T 

"F" 6 

"H" 6\ 

"L" 7 

"L" command 4 
ii S n 4 

H jh 5 
"W" 5 

/EXT 2 

15 commands 2 

arrows 7 
ASCII order 4 

BACKUP 1,3 
BASIC 3, 7 

clear 6, 8 
^command display 7 
Jommand menu 2 
'command mode 4 
command summary 4 t 7 
commands 2 
copyright 1 
create a frame 5 
cursor control 8 
cursor move 7 
cursor speed 7» 8 

damaged disk 3 
destructive cursor S 
Disk Storage 4. 6 
Dot Writer 2 
dots high 5 
dots wide 5 
drawing 7 

exit 7 
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File Number 3 
flashing minus 
flasing dot 6 
frame 2» 5, 6 
frame creation 
rame size 5 



GEAP MENU 7 
graphic commands 
graphic mode 6» 7 



height 5 
hi-res 5 
high resolution 2 

introduction 2 

list 7 
loader 3 
logo 4 

machine language 3 
Manipulation Utility 5 
maximum file size 6 
maximum lettsrset storage 
memory size 3 " 
minimum files 2 
minimum programs 2 
moving cursor 7 

NEWSCRIPT 7 
nondestructive cursor " 8 

overview 2 

period 6 

pixel 2 

pointers on frame size 5 

print 5 

printer 5 

printer lines 5 

protected memory 3 

redraw frame 6 
renturn procedure 1 

SAVE 4 

saving letters 4 
SHIFT S 

speed 3 
storage limits 6 
supported printers 2 

TGEAPi/EXT 2 
TGEAP2/EXT 2 
TGEAP3/EXT 2 
Tiny GEAP 2 
Transfer 5 

warranty 1 
width 5 
write 5 
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Patches 



Many of our users want patches to fill special needs. In response, tue either 
create the patches ourselves or supply patches that have been submitted by users. 
The following patches are offered for your use. Understand that though tue have 
created and tested ail of the patches offered here, me offer them for use at your 
risk and cannot warrant them in any may, 

fllfiX B0 Patches 

The HRX80 "looks" like one computer but prints like another. That throws the 
program. In the new version, the patch is simple, fidd one line to WP/ITQ or WP/EPS 
resoectively: 

NP/ITO Add: 
i POKE kHCD8B,0: POKE &HCD8C,0: POKE &HD452,0: POKE 
&HD453.0: POKE MD4D3.8: POKE 2cHDCH,0 

This line, when added to the beginning of WP/ITO will make the HflX86 operate 
correctlu with Dot Writer, 



' . HP/EPS fidd: 

1 POKE mmm POKE kHCARi,9: POKE kHD137,0: POKE 
IHD138 ? 8: POKE &HD1B8.0: POKE I-HDIE'9,9 

This line, when added to the beginning of WP/EPS will make the HRX88- operate 
correctly with Dot Writer. 



'Z 7» Fnn"^ and T +X = 1eUer HeiQht + Ascender 

Font N-me Frame Height Yert. Letter Suggested 

FF dots,l, n es Size .UPVtlu. 

mb 2 i|:S 2 r }<N« 

.■SE f','2 i 6+6 1 

OE j] 2 f* 2 KNR) 

PL wo L* " KNR> 

G R ^ | ^ 1<NR) 

SHADED l6f2 f 3 32 

SHADOW J£f J° + 5 J<NR> 

CM i x o * KNR) 

MB3 sl'4 if 4 '< NR > 

FANCY 24*3 t A 64 

8ALL 2 ^3 24 V"*> 

BW 94 q ^ KNR) 

?2;l J 4 i< nr > 

STENCIL 16 2 [ 32 

I SHADED l 6j2 J* | 

ILETQUAL 1^,2 +3 2 ~ 

ml 24 ' 3 2** f 

ifancy *«:s it • ?* 

I BALL 24,3 ' It 1<HR> 

ISE n;l |4 H NR> 

ISF 16.2 o " 

IFF 16 2 9 32 

ANT 3 2 * 4 J7 +8 .8 

FoC 24 »3 12+8 i 

HWT 24 3 |t? % 

LMES „ , i**r 2 

in 32 ' 4 iS+ 6 64 - 

LQ 1-6,2 10 + 4 ? 

ILQ 16 2 +4 

MES 16 2 o % l 

LED a I Z* 3 * 

SCS g'i •; KNR) 

3G0THIC 32j 4 ' KNR) 

GBB 32 4 l\ KNR) 

GOTHIC 16 ,'2 f] KNR) 

LOGO l 6 ' i2 J* KNR) 

B8 12' 2 !! +5 KNR) 

SMES 24 | if +4 KNR) 

SSS? 20 24 '' 3 ^ + * 8 

HUGE 4Q 6 . y » 

SHEER 48 6 47 <NR> 

HLINE 43 6 11 l < NR > 

^D M ; 2 4 4 <NR) 

rf^ 1<6 ' 2 ^ + 2 L 

LLAR 8 ^ 7+1- WK.n, 

ICLAR a\ ;** KNR) 

0,1 7+1 KNR) 



RCM COMPUTERS 

22! Hin.SHHl-'t.n IJR 
WIUIAMSVIlir. NY 1.1221 

7ir.-r,r!'i Atr,Hj 



% 



NewScript Filename Transfer 

/ Hany of our users appreciate the power and ease of the NewScript editor but 
miss the ability to transfer the current filename from NeaScript to OGTPRINL With the 
following patch, the transfer will be made in exactly the same manner" as with 
NewScript. The patch shown is for the Cltoh version of DGTPRINT, but the only 
difference is that in the EPSON version, the first line to be changed is 1 125, not 20 
as shown below. Everything else is the same. 

To the WP/ITO program, alter line 20 to read as follows: 

20 GOSUB13000: Z1$=A$: PRINT: IFSF$=' ,,, THENLINEINPUT ,, ENTER I. D. OF FILE TO BE PRIN 
ED (0=CANCEL) : " ; A$: G0SUB1 2000: IFA$=" "THENA$=Z 1 *: OPEN" I " , 1 , A$: LINEINPUTit 1 , EX 
: PRINTEXSELSEGPEN" I " , 1 , SF$: LINE INPUT** 1 , EX$: PRINTEX* 

In the WP/EPS program make the same change but the line number is 125! 
Now, in both WP/ITO and WP/EPS, add the following subroutine: 

5000 ' NewScript File Xfer •-- ----- 

13010 F=PEEK(&H4016)+256*PEEK(.S<H4017>- (256*256) 

13020 F$= ,, ":FaRI = 13TD41: J=PEEK'(F+I) : IFJ<>32THENF*=FS+CHR* ( J) : NEXTELSEI=4 1 : NEX 

13030 IFF$="' , THENRETURNELSEPRINT:PRINT"Current File is "F* 

1 3 1 00 I F A$= " " THEN A$=F$ : RETURN 

13110 RETURN 
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